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Anti-acknowledgements 


Before | say anything else.. 
e To the creators of the standard 
e USB2[650] + JUEOJHCI + Class specs 
O Yet most devices are not standard 


O And some controllers don't interrupt 
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USB 


Overview 
e USB 1: Low-speed (1.5M/s), Full-speed (12M/s) 
e USB 2: High-speed (12M/s) 
e USB 3: Super-speed (5G/s) 
e Polled bus (tree) = Hosts vs devices. 


e Devices = (Class, subclass, protocol) 


Oct 17, 2009 
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Host controllers 


e USB I: 
O ohci 
o uhci 

e USB 2: 
O ehci 

e USB 3: 


o xhci (couldn't get) 
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Example 2.0 bus 


port | port | port | port | port | port | port | port | port 


kb & 
hub disk 
ous 
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Devices 


e One or more functions. 
e Endpoints 

O Addressable entities 

O |n, Out, In-Out 

O With particular transfer type 
e Grouped in interfaces 


O Each with a CSP 
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Enumeration Configuration 


Address (device, endpoint) 

On attach = 

O Address 0 (config) 

O Setup endpoint (address O) 
Software assigns unique address 


Hubs are transparent 
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Transfer types 


e Or endpoint types: 
o Control 
O Bulk 
O Interrupt 
O Isochronous 


e May be high, low, full speed. 
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Control transfers 


e RPCs 

e |n or Out 

e Stages: 
O Setup 
O Data 


O Status 
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Other transfers 


e Bulk 

O Sustained In or Out xfer. 
e Interrupt 

O Not an interrupt 
e Iso 


O Timely 
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Data transfer 


Packet types (Setup, DataO, Datal, ...) 
1-bit ack (toggle) 

Exceptions for control transfers 

Error signaling 

O In-band 

O Not standard  (e.g., per-controller) 


o Ambiguous (I/O? bad request? ...) 
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Controller transfers 


UCHI, OHCI 

EHCI + [ UHCI, OHCI] 

IO + Shared memory + Interrupts (if lucky) 
There is no root hub! 

Tranfer descriptors 


O per ctlr, per type, per speed. 
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Configuration 


e Devices are self-describing 

e Binary encoded descriptors 
O Device (class, packet size, ...) 
O Class-specific 


O Device-specific 
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Summary 


Fake root hub; many transfer types. 
What's a device? = not clear. 
Which error? = not clear 
Devices do as they please 
O Most people do what Wind*ws does 


O If you fix a device you may break another 
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System softvvare 


Evolution of previous USB softvvare 
Kernel = I/O 

Daemon = Enumeration Configuration 
User programs Device drivers 


User library = Device drivers 
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System softvvare 


audio 


serial 


fu 


ehci 


uhci 


ohci 


Plan 9 kernel 
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User interface 


Not standard, but easier to understand. 


fu 


RA a RN 


ctl ep1.0 ep2.0 ep3.0 ep3.1 


Ed p" al dus 
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Example 
cat /dev/usb/ep3.0/ctl 


enabled control rw speed full maxpkt 64 
ival O samplesz O hz O hub 1 port 3 busy 


storage csp 0x500608 vid 0x951 did 0x1613 
Kingston 'DT 101 II ’ 
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Kernel drivers 


e devusb 
O portable interface 
O ctlr independent endpoints 
O file system 
e usb[ueo]hci 
O honor devusb endpoints 


o Actual I/O 
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struct Ep 


{ 


Ref; 


/* one per fid (and per dev ep for epOs) */ 


Portable endpoint 


/* const once inited. */ 


int idx; 
int nb; 
Hci* hp; 
Udev* dev; 
Ep" ep0; 


is 


/ 
/ 
/* 
/ 
/ 


* index in global eps array */ 

* endpoint number in device */ 
HCI it belongs to */ 

* device for the endpoint */ 


* control endpoint for its device */ 
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Portable endpoint 


/* configuration */ 


QLock; /* protect fields below */ 
char* name; /* for ep file names at #u/ */ 
int  inuse; /* endpoint is open */ 
int mode; /* OREAD, OWRITE, or ORDWR */ 
int  clrhalt; /* true if halt was cleared on ep. */ 
int debug; /* per endpoint debug flag */ 
char* info; /* for humans to read */ 
long maxpkt; /* maximum packet size */ 
int ttype; /* transfer type */ 
ulong load; /* in us, for a transfer of maxpkt bytes */ 
void* aux; /* for controller specific info */ 
int  rhrepl; /* fake root hub replies */ 

/ 


int toggle[2]; * saved toggles (while ep is not in use) */ 
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Portable endpoint 


struct Ep 

{ 
long pollival; * poll interval ([u]frames; intr/iso) */ 
long hz; * poll frequency (iso) */ 


long samplesz; * sample size (iso) */ 


e RR E ae 
" " " " 


int ntds; * nb. of Tds per uframe */ 
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struct Udev 


{ 


int 
int 
int 
int 
int 
int 


int 


Ep* 


nb; 

state; 

ishub; 

isroot, 

speed; 

hub; 

port; 
eps[Ndeveps]; 


Í 
/ 
/ 
/ 
/ 
/ 
/ 
/ 


USB device 


* USB device number */ 

* state for the device */ 

* hubs can allocate devices */ 

* is a root hub */ 

* Full/Low/High/No -speed */ 

* dev number for the parent hub */ 
* port number in the parent hub */ 


* end points for this device (cached) */ 
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struct Heiimpl Controller interface 


{ 
void "aux, /* for controller info */ 
void (*init)(Hci*); /* init. controller */ 
void (*dump)(Hci*); /* debug */ 
void (*interrupt)(Ureg*, void*);  /* service interrupt */ 
void (*epopen)(Ep*); /* prepare ep. for I/O */ 
void (*epclose)(Ep*); /* terminate I/O on ep. */ 
long (*epread)(Ep*,void*, long);  /* transmit data for ep */ 
long (*epwrite)(Ep*,void*,long); /* receive data for ep */ 
char” (*seprintep)(char*,char*,Ep*); /* debug */ 
int (*portenable)(Hci*, int, int); /* enable/disable port */ 
int (*portreset)(Hci*, int, int); /* set/clear port reset */ 
int (*portstatus)(Hci*, int); /* get port status */ 
void (*debug)(Hci*, int); /* set/clear debug flag */ 
$; 
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usbjueolhci epread/epvvrite 


Endpoint I/O 

Endpoint open only while in use 

O (devusb keeps cfg. between opens) 
Fake root-hub port poll 

O But not a full hub emulation 


Control and Iso are timed out 
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Control transfer 


device zu device 
usbcmdo——— ——o 
write setup 
O =O 
data 
O =O 
status 
Oz O 
return 
Q-—— O 
usbcmd - 
write setup 
C - 
data 
Oz 
status 
Oz 
return 
QE q 
y 
read 
Q«— ——« 
time V return y y 
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Enumeration Hot plug 


device zu usbd driver 
device attach o 
port poll 
port config 
Qe—— =0 
device config 
Oz ) . 
start driver 
_ Qe— =O 
devicelconfig 
Qu =O 
: device in use : : 
device detach 
port poll 
= 
detach 
>= - 
i/o érror 
j= > 
detach 
= 
time y y y y 
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Device drivers 


e Not to be confussed with devusb/usb[ueo]hci 


audio 


serial 


ehci 


ohci 


Plan 9 kernel 
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Device drivers 


e usbd: = 
O enumeration 
O initial configuration 
e driver = 
O device specific configuration 
O device I/O (unless named endpoint) 


e + support library 
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USB device (endpoint) 


struct Dev 

{ 
Ref; 
char” dir; /* path for the endpoint dir */ 
int id; /* usb id for device or ep. number */ 
int dfd; /* descriptor for the data file " / 
int cfd; /* descriptor for the control file */ 
int maxpkt; /* cached from usb description */ 
Ref nerrs; /* number of errors in requests */ 
Usbdev* usb; /* USB description */ 
void* aux; /* for the device driver */ 


void (*free)(void*);  /* idem. to release aux */ 
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USB device configuration 


struct Usbdev 


{ 

ulong csp; /* USB class/subclass/proto */ 

int vid; /* vendor id */ 

int did; /* product (device) id */ 

char* vendor, *product, *serial; 

int  vsid, psid, ssid; 

int class; /* from descriptor */ 

int nconf; /* from descriptor */ 

Conf* conf[Nconf]; /* configurations */ 

Ep* ep[Nep]; /* all endpoints in device */ 

Desc* ddesc[Nddesc]; /* (raw) device specific descriptors */ 
I 
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USB device configuration 


struct Ep 
{ 
uchar addr, /* endpt address, 0-15 (I0x80 if Ein) */ 
uchar dir; /* direction, Ein/Eout */ 
uchar type; /* Econtrol, Eiso, Ebulk, Eintr */ 
uchar isotype; /* Eunknown, Easync, Eadapt, Esync */ 
int id; 
int maxpkt; /* max. packet size */ 
int ntds; /* nb. of Tds per uframe */ 
Conf* conf; /* the endpoint belongs to */ 
Iface*iface; /* the endpoint belongs to */ 
h 
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Modules? 


Code kept in library 

separate main (replaces usbd) 
O linked against library 
linked into usbd 


linked as a separate program 
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Usbd configuration 


embed 
kb  csp=0x010103 csp=0x020103  args- 
disk class-storage — args- 

auto 


ether class=comms  args= 
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Example 


int 


kbmain(Dev *d, int argc, char” argv[]) 


{ 
ARGBEGIN{ 
JARGEND, 
if(ok) 
start(d); 
else 
closedev(d); 
return O; 
} 
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Example 


void 


threadmain(int argc, char **argv) 


{ 
ARGBEGIN{ 
as = seprint(as, ae, " -k"); 
JARGEND; 
startdevs(args, argv, argc, matchdevcsp, csps, kbmain); 
threadexits(nil); 
} 
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Device file systems 


Most drivers have a file system 
FS interface is almost static 

FS problems must not abort 

o embedded devices 

Several FSs must be combined 


O Stackable (usb / usbdir / devfs) 
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struct Usbfs 


{ 


char 


Device file system 


name[Namesz]; 


uvlong qid; 


Dev* 


void* 


int 
void 
void 
int 
long 
long 
int 


void 


dev; 

aux; 

(*walk)(Usbfs *fs, Fid *f, char *name); 

(*clone)(Usbfs "fs, Fid "of, Fid *nf); 

(*clunk)(Usbfs *fs, Fid *f); 

(*open)(Usbfs *fs, Fid *f, int mode); 

(*read)(Usbfs *fs, Fid *f, void *data, long count, vlong offset); 
(*write)(Usbfs *fs, Fid*f, void “data, long count, vlong offset); 
(*stat)(Usbfs *fs, Qid q, Dir *d); 

(*end)(Usbfs *fs); 
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Device file system 


Concurrent requests 

O Open, read, write 

Others automatic 

o Walk, clone, clunk, stat, end 
Per fs name. 


Decorated Qids 
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Implementation 


1470 /sys/src/9/pc/devusb.c 
705 /sys/src/9/pc/devusbcons.c 
194 /sys/src/9/pc/usb.h 

3340 /sys/src/9/pc/usbehci.c 
147 /sys/src/9/pc/usbehci.h 
2545 /sys/src/9/pc/usbohci.c 
2301 /sys/src/9/pc/usbuhci.c 
10702 total 
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Implementation 


2448 /sys/src/cmd/usb/audio/... 
2710 /sys/src/cmd/usb/disk/... 
2924 /sys/src/cmd/usb/ether/... 
724 /sys/src/cmd/usb/kb/... 
2617 /sys/src/cmd/usb/lib/... 
1272 /sys/src/cmd/usb/usbd/... 


14240 total 
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Problems 


Iso-read on OHCI 
Too many ilocks 
64-bit cleanup 
Profiling 

More devices 


USB 3.0 
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